home *** CD-ROM | disk | FTP | other *** search
/ Gigarom 4 / Mac Giga-ROM 4.0 - 1993.toast / FILES / COP / A-M / Extra Translators 4 SD.sea / Translator Documentation / About AppleLink Translator next >
Text File  |  1991-02-21  |  12KB  |  311 lines
  1. AppleLink Translator for StuffIt Deluxe
  2. -----------------------------------
  3.  
  4. Version 1.0 of 20 Feb 1991
  5.  
  6. Written by Terry Teague
  7.  
  8. Copyright (C) 1991, Aladdin Systems, Inc  &
  9.                                Apple Computer, Inc.
  10. All Rights Reserved.
  11.  
  12.  
  13. This software is being licensed to you free of cost.
  14.  
  15. Please see Terms of usage and distribution at the end
  16. of this document for information regarding your right
  17. to use and distribute this software.
  18.  
  19.  
  20.  
  21. Introduction:
  22. -----------
  23.  
  24. AppleLink Translator is an external translator for use
  25. with StuffIt Deluxe, available from Aladdin Systems, Inc.,
  26. Deer Park Center, #23A-171, Aptos, CA 95003-4723.
  27.  
  28. This translator provides compatibility with the AppleLink
  29. package facility of AppleLink 5.0, 5.1, and 6.0.
  30.  
  31. This translator requires that you have StuffIt Deluxe or
  32. StuffIt Classic.  It is designed for uncompressing AppleLink
  33. packages and creating AppleLink packages without requiring
  34. the AppleLink application itself.
  35.  
  36.  
  37. Installation:
  38. -----------
  39.  
  40. The rest of this documentation assumes that you have properly
  41. installed StuffIt Deluxe and are familiar with the operation
  42. of StuffIt Deluxe.
  43.  
  44. To install this translator, placed it in the Translators
  45. folder in the System folder of your startup drive.  Then
  46. launch (or quit and relaunch, as appropriate) StuffIt Deluxe.
  47.  
  48. If you are in Standard menu mode, you must switch to Expert
  49. menu mode to use this translator.
  50.  
  51.  
  52. Operation:
  53. ---------
  54.  
  55. After installation, you will have a new choice under the
  56. Other menu with the name "AppleLink Package". This is a
  57. hierarchical menu, with additional choices of "Expand from
  58. Package…" and "Compress into Package…". Operation of the
  59. translator can occur in the background, when running under
  60. MultiFinder™ or System 7.0, if so desired.
  61.  
  62. Expand from Package:
  63. -------------------
  64.  
  65. To expand the contents of an AppleLink Package, choose the
  66. "Expand" menu option. You will be presented with a Standard
  67. File Dialog, which will allow you to select a Package to
  68. expand, or Cancel etc. The Package will be opened, and a new
  69. modified Standard File Dialog will be presented. The contents
  70. of the package will be displayed in a list in the dialog. If the
  71. package was created by a recent version of AppleLink, such as
  72. 6.0, it is possible that the package contains hierarchical folders,
  73. much like the standard Macintosh Hierarchical Filing System.
  74. In such cases, it is possible to select a folder, and double-click
  75. on it to display its contents. Double-clicking on the folder name
  76. again (which will be displayed above its contents), will "collapse"
  77. the folder structure. If you never select any folder or file to
  78. expand, the Save button is disabled, and the default is Save All.
  79. However, if you select a folder or file name, its name will be
  80. placed in the editable text area, and the Save button will be
  81. enabled - this allows you to save a single folder or file, or give
  82. it a new name on the destination disk. You can select multiple
  83. folders or files to save, by shift-clicking to select contiguous
  84. items, or by command-clicking to select discontiguous items.
  85. If you select multiple items, the Save button will be disabled.
  86.  
  87. Select the destination disk/folder by the usual means. The dialog
  88. will also show the amount of disk space that the expanded files
  89. will occupy, and the current amount of free disk space on the
  90. destination disk. 
  91.  
  92. There is also a checkbox to automatically delete the package after
  93. it has been expanded. And a button for creating a New Folder.
  94.  
  95. Once you have selected the files to expand, and the destination, click
  96. on the Save or Save All button as appropriate. A progress dialog will
  97. be displayed, and progress indicated, as the files are expanded.
  98.  
  99. If you selected Save, rather than Save All, then the dialog will be
  100. presented again, to repeat the above operations, until such time
  101. you Cancel (the Done button), all the files have been expanded, or
  102. some error occurs.
  103.  
  104. Compress into Package:
  105. ---------------------
  106.  
  107. To compress selected files into an AppleLink Package, choose the
  108. "Compress" menu option. You will be presented with a modified
  109. Standard File Dialog, which will allow you to select files and
  110. folders to compress. Use the Add button to add selected files
  111. and folders to the package. You can open selected folders by clicking
  112. the Open button, or double-clicking on the folder name. You can
  113. double-click on selected files as a shortcut to Add them.
  114.  
  115. The contents of the package will be displayed in a list in the dialog.
  116. The uncompressed size of the folder or file will also be displayed.
  117. The package can contain hierarchical folders, much like the standard
  118. Macintosh Hierarchical Filing System. In such cases, it is possible to
  119. select a folder, and double-click on it to display its contents.
  120. Double-clicking on the folder name again (which will be displayed
  121. above its contents), will "collapse" the folder structure.
  122.  
  123. If a folder or file is selected in this list, the Remove button will be
  124. enabled, if you wish to remove the selected folder or file.
  125. Tip: to compress a whole folder except for a few files, select the
  126. whole folder to compress, then select the folder name in the list,
  127. double-click to reveal its contents, and select individual files to
  128. remove.
  129.  
  130. Once a folder or file has been added to the package, the Compress…
  131. button is enabled. You may choose this button to compress the
  132. package, or Cancel. If Compress… is selected, you will be presented
  133. with a Standard File Dialog that will allow you to select the destination
  134. disk, a destination package name, or Cancel etc.
  135.  
  136. Once you have selected to compress the package, a progress dialog
  137. will be displayed, and progress indicated, as the files are compressed.
  138.  
  139. Finally, a dialog showing the savings made by compressing into a
  140. package, will be displayed.
  141.  
  142.  
  143. Appendix A: Terms of usage and distribution:
  144. ----------
  145.  
  146. Although copyrighted, this software is being licensed 
  147. to you for your use free of charge.  However, ownership
  148. of, and interest in this software shall remain with the
  149. author.  Use and distribution of this software is
  150. governed by the following terms in an effort to
  151. reasonably insure that this software will remain
  152. freely available and that no one other than the author
  153. will derive a commercial benefit from distributing
  154. this software.
  155.  
  156.  
  157. LICENSE AGREEMENT
  158. ------------------
  159.  
  160. "You," "your," and the "user" refers to any person or
  161. entity which acquires or uses this software.
  162.  
  163. "Software" refers to any computer programs identified
  164. at the start of this documentation file, together with
  165. all codes, techniques, software tools, formats, designs,
  166. concepts, methods, ideas, and documentation assoicated
  167. with the computer program(s).  The term also includes
  168. all copies of any part of the software and documentation.
  169.  
  170. "Author" refers to the author of this software, Aladdin
  171. Systems, Inc.
  172.  
  173.  
  174. This software is owned by the author and contains
  175. valuable and proprietary information of the author.
  176. If you violate any part of this agreement, your right
  177. to use this software terminates automatically.  In the
  178. event of termination of this agreement, you must destroy
  179. all copies of this software and derivatives of this
  180. software in your possession and cease distributing the
  181. same.
  182.  
  183. This software is being licensed to you as provided by
  184. the terms of this agreement.
  185.  
  186. You may:
  187.    1. Use this software on as many computers
  188.       as you want at any given time.
  189.    2. Make as many backup copies of this software as
  190.       you want.
  191.    3. Alter the software in any manner you see fit
  192.       FOR YOUR OWN PERSONAL USE.  Such altered versions
  193.       should not be distributed.  The creation of
  194.       such derivatives shall not diminish the author's
  195.       title to this software.
  196.    4. Terminate this agreement at any time by destroying
  197.       all copies of this software and derivatives of
  198.       this software and cease distributing the same.
  199.  
  200. You may not:
  201.    1. Create any derivative works from this software
  202.       for distribution.
  203.    2. Reverse engineer, disassemble, decompile, or
  204.       otherwise attempt to discover the source code to
  205.       this software.
  206.    3. Use this software in any manner as to discover
  207.       proprietary information relating to the Translator
  208.       interface in StuffIt Deluxe.
  209.  
  210.  
  211. You may distribute this software provided that:
  212.    1. This software is distributed free of any charges
  213.       except as provided for under 1a.  This software may
  214.       not be sub-licensed, sold, lent, rented, or leased
  215.       except as provided for under 1a.
  216.           1a. You may charge a nominal fee to cover
  217.               duplication, shipping and/or handling costs
  218.               of distributing this software provided that
  219.               the pro-rata fee (ex: the fee of ordering a
  220.               disk/CD/tape/etc divided by the number of 
  221.               programs on it) does not exceed US $1.  You
  222.               may include this software in any compilation
  223.               even if you sell the compilation for a
  224.               profit provided that the pro-rata fee defined
  225.               above does not exceed US $1 for this software.
  226.  
  227.               You may also charge your usual timesharing,
  228.               network usage and/or membership fee if you
  229.               distribute this software electronically.
  230.  
  231.               While you may claim a compilation copyright
  232.               on any compilations which include this
  233.               software, interest in and ownership of this
  234.               software shall remain with the author.
  235.             
  236.    2. You include this documentation file with the
  237.       distribution.
  238.    3. You do not modify either this documentation file
  239.       or the software itself.
  240.    4. You do not use the name of this software or
  241.       of the author or the fact that you provide this
  242.       software in any promotional material relating
  243.       to your distribution of this software.  However, you
  244.       may include such information in a catalog listing of
  245.       your offerings.
  246.    5. You may not transfer this software in a manner as
  247.       to violate any regulations relating to the transfer
  248.       of software, including the US Export Administration
  249.       Act.
  250.  
  251. Disclaimer of warranty:
  252. ---------------------
  253.  
  254. In using this software, you understand and agree that this
  255. software is provided "as is" without warranty of any kind.
  256. The entire risk as to the results and performance of using
  257. this software lies entirely with you, the user.  The author
  258. does not make any warranties, either expressed or implied,
  259. including but not limited to implied warranties of
  260. merchantability and fitness for a particular purpose, with
  261. respect to this software.
  262.  
  263. In no event shall the author be liable for any consequential,
  264. incidental, or special damages whatsoever (including without
  265. limitation damages for loss of critical data, loss of profits,
  266. interruption of business, and the like) arising out of the
  267. use or inability to use this software.
  268.  
  269. Although the author would appreciate any feedback and bug
  270. reports, the author shall not be responsible for correcting
  271. any problems which you discover or otherwise help you
  272. maintain and use this software.  Furthermore, the author
  273. may at any time replace, modify, alter, improve, enhance
  274. or change this software.
  275.  
  276.  
  277. Complete agreement:
  278. ------------------
  279.  
  280. This agreement constitues the entire agreement and supersedes
  281. any prior agreements between you and the author concerning
  282. this software.  This agreement cannot be amended, modified,
  283. or waived except in writing.
  284.  
  285. General:
  286. -------
  287.  
  288. If any provision of this agreement is found to be
  289. unenforcible, it shall be deemed severed from the remainder
  290. of this agreement.
  291.  
  292. This agreement shall be construed in accordance with the laws
  293. of the State of New York.  Any arbitration or litigation
  294. relating to this agreement shall take place in the State of
  295. New York.
  296.  
  297.  
  298.  
  299. U.S. GOVERNMENT RESTRICTED RIGHTS
  300. ----------------------------------
  301.  
  302. This Software is provided with RESTRICTED RIGHTS.  Use,
  303. duplication, or disclosure by the government is subject to
  304. restrictions set forth in subparagraph (c)(1)(ii) of the
  305. Rights in Technical Data and Computer Software clause at
  306. 48 CFR 252.227-7013, or in subparagraphs (a) through (d) of
  307. the Commercial Computer Software Restricted Rights clause at
  308. 48 CFR 52.227-19, as applicable.  The manufacturer
  309. is Aladdin Systems, Inc.  Deer Park Center, Suite 23A-171,
  310. Aptos, CA, 95003.
  311.